feat: add devnet support #527

redpanda-f · 2026-01-02T09:54:33Z

This PR adds comprehensive support for local Filecoin networks to enable easier development and testing.

Changes

Add localnet support to Synapse SDK for local Filecoin network development
Introduce localnet configuration utilities with environment variable support for chain ID, RPC URLs, and contract addresses
Update FilecoinNetworkType to include 'localnet' alongside mainnet and calibration
Enhance network detection to automatically recognize localnet by chain ID
Add localnet contract address resolution with required/optional address validation
Update example scripts (storage-e2e, post-deploy-setup) to support --network localnet option
Export localnet configuration from synapse-core and synapse-sdk packages
Maintain backward compatibility with existing mainnet/calibration functionality

Environment Variables

The following environment variables can be used to configure localnet:

LOCALNET_CHAIN_ID (default: 1414)
LOCALNET_RPC_URL (default: http://127.0.0.1:5700/rpc/v1)
LOCALNET_RPC_WS_URL (default: ws://127.0.0.1:5700/rpc/v1)
LOCALNET_BLOCK_EXPLORER_URL (default: http://localhost:8080)
LOCALNET_MULTICALL3_ADDRESS,
LOCALNET_USDFC_ADDRESS, etc. for contract addresses

cloudflare-workers-and-pages · 2026-01-02T09:54:39Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	synapse-dev	`bde461c`	Commit Preview URL Branch Preview URL	Jan 15 2026, 04:30 AM

BigLep · 2026-01-05T23:08:38Z

@redpanda-f : will you take care of the lint failures?

packages/synapse-sdk/src/index.ts

packages/synapse-core/src/localnet-config.ts

packages/synapse-sdk/src/utils/constants.ts

utils/example-storage-e2e.js

hugomrdias

LGTM just needs docs update, the utils folder i will leave to Rod.

ps. with viem all this "add multicall everywhere" wont be needed

packages/synapse-sdk/README.md

packages/synapse-sdk/src/types.ts

packages/synapse-sdk/src/payments/service.ts

rvagg

@redpanda-f I hope you don't mind that I rebased this and pushed another commit with fixes for things I was noticing (cause I'm trying to make progress using foc-localnet for testing atm).

Approving but still untested .. I'll come back and merge if all goes well.

rvagg · 2026-01-15T11:35:42Z

Approving but still untested .. I'll come back and merge if all goes well.

I still haven't quite got this tested and proven! Although I have a local branch of foc-localnet that uses these changes. I'll get that PR up soon to make use of this.

redpanda-f requested review from hugomrdias and rvagg as code owners January 2, 2026 09:54

github-project-automation bot added this to FOC Jan 2, 2026

github-project-automation bot moved this to 📌 Triage in FOC Jan 2, 2026

redpanda-f changed the title ~~feat: Add Localnet Support to Synapse SDK~~ feat: (foc-localnet-v1-rc) Add Localnet Support to Synapse SDK Jan 2, 2026

BigLep moved this from 📌 Triage to 🔎 Awaiting review in FOC Jan 5, 2026

BigLep assigned redpanda-f Jan 5, 2026

rvagg force-pushed the feat/redpanda/localnet-support branch from 4431d7c to ebfd645 Compare January 6, 2026 05:21